NOM¶

blackbox - Un gestionnaire de fenêtre pour X11

SYNOPSIS¶

blackbox -help | -version
blackbox [ -rc fichier_rc ] [ -display affichage ]

DESCRIPTION¶

Blackbox est un ajout de plus à la liste des gestionnaires de fenêtres pour le Système de Fenêtres X de l'Open Group, Version 11 Release 6 et au-delà. Blackbox est implémenté en C++, et ne reprend aucune ligne de code d'un autre gestionnaire de fenêtres (bien que l'implémentation des graphiques soit similaire à celle de Window Maker).

Dès l'heure où la première ligne de code fut écrite, Blackbox a évolué autour d'un principe : le minimalisme. Il n'est pas conçu pour être agréable au regard, ni pour être le plus riche en fonctionnalités, ni le plus décoré pour ressembler à l'interface NeXt, la plus largement connue. Il est simplement conçu pour être rapide.

Blackbox fournit des décorations de fenêtres configurables, un menu racine pour lancer des applications et une barre-outil qui indique le nom de l'espace de travail courant, le nom de l'application disposant du clavier, et l'heure courante. Il dispose aussi d'un menu pour gérer les espaces de travail (ajout ou suppression). La `fente' (NDT. slit) est utilisable pour accrocher de petites applications, comme la plupart des outils-bb (NDT. bbtools), par exemple.

Blackbox fournit une gestion des icônes d'un type particulier : lorsqu'on réduit en icône une fenêtre, aucun icône n'apparaît ; en revanche, le nom de l'application est ajouté dans le sous-menu `Icones' du menu des espaces de travail. Ainsi, votre bureau ne sera jamais embarrassé par une multitude d'icônes éparpillées. Comme alternative aux icônes, les fenêtres fantômes sont mises à disposition : un double-clic sur la barre de titre d'une fenêtre la rend fantôme (c'est-à-dire que la fenêtre disparaît et seule sa barre de titre demeure visible).

Blackbox utilise ses propres classes graphiques pour produire ses images à la volées. Par l'utilisation de fichiers de styles, vous pouvez très finement déterminer à quoi ressemble votre bureau. Blackbox utilise actuellement son propre protocole pour communiquer avec les clients tels que les pagineurs. Le travail est en cours pour supporter les nouvelles spécifications de gestionnaires de fenêtres que GNOME et KDE utilisent.

OPTIONS¶

Blackbox comprend les options de ligne de commande suivantes :

-help

Affiche les options de ligne de commande, les fonctionnalités supportées, puis se termine.

-version

Affiche les informations de version et se termine.

-rc fichier_rc

Utilise un autre fichier de contrôle d'exécution que celui par défaut ~/.blackboxrc.

-display affichage

Démarre Blackbox sur l'affichage spécifié. Les programmes lancés par Blackbox auront également la variable d'environnement DISPLAY positionnée à cette valeur.

EXÉCUTER BLACKBOX¶

Le programme est habituellement exécuté par le script de démarrage de l'utilisateur, la plupart du temps nommé ~/.xinitrc ou ~/.xsession. Pour exécuter blackbox, modifiez le script en ajoutant

0
exec blackbox

Lorsqu'il démarre, Blackbox essaie de trouver un fichier de menu par défaut dans /usr/local/share/blackbox/menu. Vous pouvez y configurer un menu global pour les utilisateurs.

Lors de l'arrêt ou du redémarrage, Blackbox enregistre les options par défaut de l'utilisateur dans le fichier ~/.blackboxrc dans le répertoire de l'utilisateur. Certaines ressources de ce fichier peuvent être éditées manuellement.

UTILISER BLACKBOX¶

Depuis la version 0.60.x, Blackbox n'assume plus lui-même la gestion du clavier ; pour cela, il s'appuie sur un programme externe bbkeys(1). Aussi, dans cette section, nous n'abordons que les commandes liées à la souris.

FICHIER DE MENU¶

Un fichier de menu par défaut est installé dans /usr/local/share/blackbox/menu. Bien sûr, ce menu global pour le système peut être configuré pour tous les utilisateurs simultanément. Mais il est également possible de créer un menu personnel. Il est habituel de créer un répertoire ~/.blackbox/ (ou ~/blackbox/) dans votre répertoire d'utilisateur, et d'y créer un fichier de menu, par exemple menu, ou d'y copier le fichier du menu global. Ensuite, il faut indiquer à Blackbox de charger votre menu de fichier plutôt que celui par défaut. Pour cela il faut ajouter une ressource (ou changer sa valeur) dans le fichier ~/.blackboxrc :

session.menuFile:       ~/.blackbox/menu

Pour que cette modification prenne effet, Blackbox doit être redémarré. Assurez-vous que le menu est utilisable, puis sélectionnez « Redémarrer » dans le menu racine par défaut de Blackbox.

[étiquette] (libellé ou fichier) {commande ou fichier}

[exec] (\(mon super\) \{XTERM\}) {xterm -T \"super XTERM\"}

# Fichier de menu Blackbox
[begin] (Blackbox 0.62.2pre0)


  [exec] (rxvt) {rxvt -ls}


  [exec] (Mozilla) {mozilla}


  [exec] (The GIMP) {gimp}


  [submenu] (Gestionnaire de fenêtres)


    [exec] (Édition Menus) {nedit .blackbox/Menu}


    [submenu] (Style) {Quel Style ?}


      [stylesdir] (~/.blackbox/styles)


      [stylesmenu] (Styles Blackbox) {/usr/local/share/blackbox/styles}


    [end]


    [config] (Options de Config.)


    [reconfig] (Reconfigurer)


    [restart] (Redémarrer)


  [end]


  [exit] (Déconnexion)
[end]
# Fin du fichier de menu

STYLES¶

Pour déterminer l'apparence générale des bordures de fenêtres, des menus et de la barre-outil, Blackbox recourt à des fichiers spécifiques contenant des ressources X(1). Ces dernières permettent de spécifier les couleurs, les textures et les polices de caractères.

L'installation par défaut de Blackbox fournit quelques fichiers de style. Ils sont habituellement copiés dans /usr/local/share/blackbox/styles. Vous pouvez étudier ou éditer ces fichiers pour comprendre comment fonctionnent les styles dans Blackbox. Les commandes [style], [stylesdir] et [stylesmenu] placées dans votre fichier de menu vous permettent de changer de style à la volée en le sélectionnant simplement dans votre menu.

Vous pouvez aussi créer un répertoire dans votre répertoire d'utilisateur (habituellement nommé ~/.blackbox/styles) et y placer vos propres styles. Vous avez bien sûr le choix dans le nom du répertoire, mais de nombreux styles à télécharger s'appuient sur le nom styles (selon le modèle de nom de bb.themes.org).

Pour comprendre comment les styles fonctionnent, vous devez avoir une légère connaissance sur le fonctionnement des ressources X.

Les ressources X consistent en une clé et une valeur. La clé est constituée d'un certain nombre de clés plus petites (parfois référencées sous le nom d'enfants), délimitées par un point (`.'). Les clés peuvent aussi contenir une astérisque (`*') qui sert de joker, ce qui signifie qu'une seule ligne de texte saisie peut correspondre à plusieurs clés. Ce cas est très utile lorsque le style est basé sur une ou deux couleurs.

Blackbox vous autorise à configurer ses quatre composants principaux : la barre-outil, la fente, les menus et la décoration des fenêtres.

La petite fenêtre qui affiche la position (x,y) pendant que vous déplacez une fenêtre emprunte son style aux barres de titre des fenêtres.

Voici quelques exemples rapides :

toolbar.clock.color:	green

menu*color:	rgb:3/4/5

*font:	-b&h-lucida-medium-r-normal-*-*-140-*

Mais ce qui rend Blackbox si spectaculaire, c'est sa capacité à produire des textures à la volée. Les descriptions de textures sont spécifiées d'une façon semblable à celle des couleurs illustrée précédemment. Par exemple :

toolbar.clock:	Raised Gradient Diagonal Bevel1
toolbar.clock.color:	rgb:8/6/4
toolbar.clock.colorTo:	rgb:4/3/2

Flat / Raised / Sunken

donne au composant un aspect plat (Flat), bombé (Raised) ou enfoncé (Sunken).

Gradient / Solid

indique à Blackbox d'utiliser une couleur uniforme (Solid) ou d'appliquer une texture dégradée (Gradient).

Horizontal / Vertical / Diagonal / Crossdiagonal / Pipecross / Elliptic / Rectangle / Pyramid

sélectionne le type de texture : horizontal, vertical, diagonal (d'en haut à gauche à en bas à droite), diagonal croisé (Crossdiagonal - d'en haut à droite à en bas à gauche), croisement de tuyaux (Pipecross), elliptique (Elliptic), rectangulaire (Rectangle) ou pyramidal (Pyramid). Cela n'est utile que lorsque Gradient est également spécifié !

Interlaced

indique à Blackbox d'entrelacer la texture (une ligne sur deux est assombrie). Cette option est plus couramment utilisée avec les textures dégradées, mais depuis Blackbox version 0.60.3, elle est aussi disponible avec les textures uniformes.

Bevel1 / Bevel2

indique à Blackbox quel type de relief utiliser. Bevel1 est le relief par défaut. L'ombre est placée au bord de l'image. Bevel2 est une alternative. Le trait d'ombre est placé à un pixel du bord de l'image.

A la place de la description d'une texture, l'option ParentRelative est aussi disponible, ce qui rend le composant semblable à son parent, autrement dit il est totalement transparent.

Toutes les textures dégradées sont composées de deux valeurs de couleur : les ressources color et colorTo. color représente la couleur initiale et colorTo la couleur finale du dégradé. Lorsque Interlaced est utilisé conjointement au mode Solid, la ressource colorTo est utilisée pour spécifier la couleur d'entrelacement.

Bien, voici la liste complète des composants, avec le type de valeur qu'ils acceptent. Les commentaires sont précédés d'un point d'exclamation (!), qui est aussi utilisé pour les commentaires dans le fichier de style Blackbox, tout autant que dans les fichiers de ressources X.

! La barre-outil elle-même.
toolbar:	Texture
toolbar.color:	Couleur
toolbar.colorTo:	Couleur
! Les boutons de la barre-outil.
toolbar.button:	Texture ou ParentRelative
toolbar.button.color:	Couleur
toolbar.button.colorTo:	Couleur
! Couleur des flèches des boutons.
toolbar.button.picColor:	Couleur
! Boutons dans l'état enfoncé (cliqué).
toolbar.button.pressed:	Texture (p.ex. Sunken) ou ParentRelative
toolbar.button.pressed.color:	Couleur
toolbar.button.pressed.colorTo:	Couleur
! Couleur des flèches des boutons dans l'état enfoncé (cliqué).
toolbar.button.pressed.picColor:	Couleur
! Le libellé de l'espace de travail sur la barre-outil.
toolbar.label:	Texture ou ParentRelative
toolbar.label.color:	Couleur
toolbar.label.colorTo:	Couleur
toolbar.label.textColor:	Couleur
! Le titre de la fenêtre active sur la barre-outil.
toolbar.windowLabel:	Texture ou ParentRelative
toolbar.windowLabel.color:	Couleur
toolbar.windowLabel.colorTo:	Couleur
toolbar.windowLabel.textColor:	Couleur
! L'horloge sur la barre-outil.
toolbar.clock:	Texture ou ParentRelative
toolbar.clock.color:	Couleur
toolbar.clock.colorTo:	Couleur
toolbar.clock.textColor:	Couleur
! Comment le texte de la barre-outil doit être aligné.
! Centré (center), à gauche (left) ou à droite (right).
toolbar.justify:	center, left, or right
! Police de caractères à utiliser avec tous les composants de la barre-outil.
toolbar.font:	Fonte (p.ex. -*-helvetica-medium-r-normal-*-*-100-*)
! Barre de titre du menu.
menu.title:	Texture
menu.title.color:	Couleur
menu.title.colorTo:	Couleur
menu.title.textColor:	Couleur
menu.title.font:	Fonte
menu.title.justify:	center, left ou right
! Le menu lui-même.
menu.frame:	Texture
menu.frame.color:	Couleur
menu.frame.colorTo:	Couleur
menu.frame.textColor:	Couleur
menu.frame.disableColor:	Couleur
menu.frame.font:	Fonte
menu.frame.justify:	center, left ou right
! Les bulles pour les sous-menus.
! Vide (empty), triangle (triangle), carré (square), losange (diamond).
menu.bullet:	empty, triangle, square ou diamond
menu.bullet.position:	right or left
! Un item de menu sur-ligné.
menu.hilite:	Texture (p.ex. Raised)
menu.hilite.color:	Couleur
menu.hilite.colorTo:	Couleur
menu.hilite.textColor:	Couleur
! Une fenêtre disposant du clavier (active).
window.title.focus:	Texture
window.title.focus.color:	Couleur
window.title.focus.colorTo:	Couleur
! Une fenêtre ne disposant pas du clavier (inactive).
window.title.unfocus:	Texture
window.title.unfocus.color:	Couleur
window.title.unfocus.colorTo:	Couleur
! Titre de la fenêtre.
window.label.focus:	Texture ou ParentRelative
window.label.focus.color:	Couleur
window.label.focus.colorTo:	Couleur
window.label.focus.textColor:	Couleur
window.label.unfocus:	Texture ou ParentRelative
window.label.unfocus.color:	Couleur
window.label.unfocus.colorTo:	Couleur
window.label.unfocus.textColor:	Couleur
! Barre de saisie.
window.handle.focus:	Texture
window.handle.focus.color:	Couleur
window.handle.focus.colorTo:	Couleur
window.handle.unfocus:	Texture
window.handle.unfocus.color:	Couleur
window.handle.unfocus.colorTo:	Couleur
! Poignées de redimensionnement.
window.grip.focus:	Texture
window.grip.focus.color:	Couleur
window.grip.focus.colorTo:	Couleur
window.grip.unfocus:	Texture
window.grip.unfocus.color:	Couleur
window.grip.unfocus.colorTo:	Couleur
! Boutons de fenêtre.
window.button.focus:	Texture ou ParentRelative
window.button.focus.color:	Couleur
window.button.focus.colorTo:	Couleur
window.button.focus.picColor:	Couleur
window.button.unfocus:	Texture ou ParentRelative
window.button.unfocus.color:	Couleur
window.button.unfocus.colorTo:	Couleur
window.button.unfocus.picColor:	Couleur
window.button.pressed:	Texture (p.ex. Sunken)
window.button.pressed.color:	Couleur
window.button.pressed.colorTo:	Couleur
! Cadre autour de la fenêtre.
window.frame.focusColor:	Couleur
window.frame.unfocusColor:	Couleur
! Police de caractères et alignement.
window.font:	Fonte
window.justify:	center, left ou right
! Diverses ressources.
! Une bordure peut être dessinée autour de tous les composants.
borderWidth:	un nombre de pixels, p.ex. 1
borderColor:	Couleur
! Épaisseur des reliefs.
bevelWidth:	un nombre de pixels > 0
! Épaisseur de la barre de saisie.
handleWidth:	un nombre de pixels > 0
! Largeur du cadre des fenêtres (depuis la version 0.61).
! Lorsqu'il n'est pas spécifié, la valeur de bevelWidth est prise par défaut.
frameWidth:	un nombre de pixels >= 0
! Cette commande est exécutée chaque fois que le style est sélectionné.
! Typiquement, elle place une belle image sur la fenêtre racine.
rootCommand:	Commande shell, p.ex. bsetroot -mod 4 4 -fg rgb:	5/6/6 -bg grey20
! Certains bbtools lisent ces vieilles ressources de la version 0.51.
menuFont:	Fonte
titleFont:	Fonte

Cette liste est certes longue, mais rappelez vous lorsque vous créez votre propre style que vous pouvez facilement positionner beaucoup de clés en une seule ligne, par exemple :

*color:	slategrey
*colorTo:	darkslategrey
*unfocus.color:	darkslategrey
*unfocus.colorTo:	black
*textColor:	white
*unfocus.textColor:	lightgrey
*font:	lucidasans-10

LA FENTE¶

La fente est une fenêtre spéciale qui peut contenir des applications « accrochables » (NDT. dockable), par exemple les « outils-bb » (NDT. « bbtools ») ou les « dockapps » de WindowMaker. Lorsque des applications s'exécutent dans la fente, elles n'ont pas de bordure propre ; en revanche, elles sont encastrées dans la fente et elles sont toujours visibles sur l'espace de travail courant. Vous pouvez cliquer avec le bouton 3 sur le bord de la fente afin de faire apparaître un menu permettant de configurer sa position, son orientation et si elle doit disparaître lorsque la souris n'est plus positionnée au dessus d'elle.

La plupart des applications accrochables utilise l'option -w pour s'exécuter dans la fente. Par exemple, vous pouvez placer dans votre fichier ~/.xinitrc :

bbmail -w &
bbpager -w &
exec blackbox

FICHIER DE RESSOURCES¶

Habituellement, le fichier de ressources ~/.blackboxrc est créé et maintenu par Blackbox lui-même. Toutes les options du menu [config] (depuis la version 0.60.x), le dernier fichier de style sélectionné, le nom des espaces de travail, etc. sont automatiquement enregistrés dans ce fichier. Cependant, il y a quelques ressources que vous pouvez vouloir éditer vous-même :

session.menuFile:

Indique à Blackbox quel fichier de menu doit être chargé.

session.screen0.toolbar.widthPercent:

Détermine la proportion (en %) de la largeur de l'écran qui sera occupée par la barre-outil. La valeur par défaut est : 66.

session.screen0.strftimeFormat:

Spécifie le format d'affichage de l'heure courante sur la barre-outil. La syntaxe du format est celle de la fonction strftime(3). La valeur par défaut est : %I:%M %p.

session.autoRaiseDelay:

Spécifie le délai (en ms) avant que la fenêtre disposant du clavier ne soit élevée au premier plan. La valeur par défaut est : 250.

session.doubleClickInterval:

Spécifie le délai (en ms) en dessous duquel Blackbox considère deux clics consécutifs comme un double-clic. La valeur par défaut est : 250.

session.screen0.edgeSnapThreshold:

Lorsque vous déplacez une fenêtre sur l'écran, Blackbox peut « l'aimanter » aux extrémités de l'écran afin de faciliter son positionnement. Ce paramètre indique à Blackbox la distance (en pixels) à partir de laquelle la fenêtre se collera automatiquement aux bords. La valeur par défaut est : 0.

session.cacheMax:

Cette ressource indique à Blackbox quelle quantité de mémoire (en Ko) il peut utiliser pour conserver les pixmaps en cache sur le serveur X. Si votre machine tombe à court de mémoire, vous pouvez diminuer cette valeur. Elle est par défaut à : 200.

session.cacheLife:

Indique à Blackbox combien de temps (en minutes) les pixmaps inutilisés demeurent dans la mémoire du serveur X. La valeur par défaut est : 5.

session.colorsPerChannel:

Indique à Blackbox combien de couleurs doivent être réservées sur le serveur X pour les affichages en mode pseudocolor. Un `channel' (NDT. canal) peut être rouge, vert ou bleu. Blackbox alloue un nombre de couleurs correspondant à cette valeur puissance 3 et les rend toujours disponibles. Cette valeur doit être comprise entre 2 et 6. Lorsque vous exécutez Blackbox sur un affichage 8 bits, vous devez positionner cette ressource à 4. La valeur par défaut est : 4.

Lorsque vous exécutez Blackbox dans un environnement disposant de plusieurs écrans, la clé screen0 peut aussi être screen1, 2 etc. pour tout écran approprié.

ENVIRONNEMENT¶

HOME

Blackbox utilise $HOME pour trouver le fichier .blackboxrc, et pour résoudre le nom du fichier de style ou les noms de répertoires.

DISPLAY

Lorsqu'aucun autre affichage n'a été spécifié en ligne de commande, Blackbox s'exécute sur l'affichage désigné par cette variable.

AUTEURS et CRÉDITS¶

Tout le code a été initialement écrit et maintenu par Brad Hughes (blackbox@alug.org) puis par Jeff Raven (jraven@psu.edu), il est dorénavant maintenu par Sean 'Shaleh' Perry (shaleh@debian.org) avec les contributions et la fusion de patches provenant de nombreux individus de par le monde.

L'adresse du site officiel de Blackbox est : http://blackboxwm.sf.net
La page des défauts (NDT. bugs) et des demandes de fonctionnalités, ainsi que les versions courantes sont accessibles à : http://sf.net/projects/blackboxwm
De nombreux thèmes et d'autres contributions sont disponibles à : http://bb.themes.org/

Cette page de manuel a été rédigée par Wilbert Berendsen (wbsoft@xs4all.nl) et traduite en français par Bertrand Duret (bertrand.duret@libertysurf.fr). De nombreuses autres traductions seront bientôt disponibles.

VOIR AUSSI¶

bsetroot(1), bbkeys(1)